home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / hv210.zip / CUSTOM.TXT next >
Text File  |  1992-01-09  |  20KB  |  532 lines
  1. Copyright 1991-1992 Hware Corporation.
  2.  
  3. Hviews Installation
  4.  
  5. Overview
  6.  
  7. The installation program is a Windows program.  It will copy all the
  8. programs and data from the installation diskette onto the user hard
  9. disk.  After all the copying is done the installation program will
  10. build a new program group with the Hviews icon in it. This icon is the
  11. Hviews icon.
  12.  
  13. After, the new group is installed then a second program (HVIEWSB.EXE)
  14. will be loaded if the installation program doesn't detect Hviews
  15. having been installed previously.
  16.  
  17. This program will build Hviews icon groups for every existing program
  18. manager group and will build one group named "All icons" that will
  19. contain all the icons from all the program manager groups. Also, at
  20. this time a file (HVIEWS.HVI) containing icons for each of the
  21. applications that are associated to document types is built.
  22.  
  23. Note that the Program Manager allows icons to exist in a group after
  24. the corresponding programs and / or files have been deleted or moved.
  25. Hviews Builder must have access to the program file to obtain it's
  26. icon. If the program file isn't founded then a substitute icon will be
  27. used.  This default icon is a black circle with a red line drawn
  28. through it.
  29.  
  30.  
  31. Installation process
  32.  
  33. Place the Hviews disk in the appropriate diskette drive.  From Program
  34. Manager use the Run command and enter the diskette drive and program
  35. name INSTALL (i.e. . A:INSTALL).
  36.  
  37. This will start the install program which will ask the User to verify
  38. the directory that Windows is installed in. It is preferred that
  39. Hviews be installed in the Windows directory (Note that all files
  40. loaded will start with the letter H).  The directory Hviews is
  41. installed in must be in the PATH.  If you decide to install Hviews in
  42. another directory you must add the directory to the PATH if it isn't
  43. already in the PATH.
  44.  
  45. Next the installation program will display a Copy progress dialog box
  46. which indicates what files are being copied and the percent done.
  47.  
  48. After all the files are copied, the Hviews group is created for the
  49. Program Manager.  You may want to copy the Hviews icon to another
  50. program group, such as the Windows Application group.  Open the
  51. Windows Application and Hviews groups and while holding the Ctrl key
  52. down drag the Hviews icon to the Windows Application group.
  53.  
  54. Finally, if Hviews hasn't been previously installed, the Hviews
  55. Builder program is executed, which will copy all the applications
  56. installed in Program Manager's groups into Hviews's corresponding icon
  57. groups.
  58.  
  59. If Hviews has been installed before, then the HVIEWS.WIN and
  60. HVIEWS.INI files will not be copied to the harddisk and the Hviews
  61. Build program will not be execute.  This prevents overwriting the icon
  62. group files used by Hviews.
  63.  
  64.  
  65.  
  66. Using Hviews Builder
  67.  
  68. Hviews Builder is used only for creation of the Hviews icon group
  69. files and the creation of the icon file (HVIEWS.HVI) used to contain
  70. the icons of all the associations.
  71.  
  72. If the [extension] section of the WIN.INI file has been changed then
  73. the Hviews Builder program needs to be loaded and the menu item MODE,
  74. Build Associations selected to update the HVIEWS.HVI file.
  75.  
  76.  
  77.  
  78. User Customization
  79.  
  80. The Command action override bar (i.e. the push buttons along the left
  81. side of the File view) is controlled by the contents of the HVIEWS.WIN
  82. file.  The following figure shows the contents of the HVIEWS.WIN file
  83. as distributed on the Hviews installation diskette.
  84.  
  85.  
  86. $msg msg1
  87. 'No Compiler available for %ext'
  88. $msg msg2
  89. 'Operation not allowed on directory'
  90. $operation
  91. Default F       XLS     'DDE(EXCEL.EXE)  EXEC(EXCEL SYSTEM [OPEN{"%CD%FNAME"}])'
  92. Default F       XLC     'DDE(EXCEL.EXE)  EXEC(EXCEL SYSTEM [OPEN{"%CD%FNAME"}])'
  93. Default F       XLW     'DDE(EXCEL.EXE)  EXEC(EXCEL SYSTEM [OPEN{"%CD%FNAME"}])'
  94. Default F       XLM     'DDE(EXCEL.EXE)  EXEC(EXCEL SYSTEM [OPEN{"%CD%FNAME"}])'
  95. Default F       DOC     'DDE(WINWORD.EXE)  EXEC(WINWORD SYSTEM [FILEOPEN{"%CD%FNAME"}])'
  96. Default F       DOT     'DDE(WINWORD.EXE)  EXEC(WINWORD SYSTEM [FILEOPEN{"%CD%FNAME"}])'
  97. Default F       RTF     'DDE(WINWORD.EXE)  EXEC(WINWORD SYSTEM [FILEOPEN{"%CD%FNAME"}])'
  98. Default F       EXE     'PGM(%FNAME)'
  99. Default F       COM     'PGM(%FNAME)'
  100. Default F       PIF     'PGM(%FNAME)'
  101. Default F       BAT     'CMD(%NAME) wait'
  102. Default F       PAS     'CMD(%NAME.L) wait'
  103. Default F       BAS     'CMD(BASIC %NAME)'
  104. Default F       *       'WIN'
  105. Default D       *       'INT(S)'
  106. Browse  F       ZIP     'CMD(PKUNZIP -vn %fname) wait'
  107. Browse  F       *       'PGM(hbrow.exe)           PARM(%FNAME)'
  108. Browse  D       *       'INT(S)'
  109. Edit    F       *       'PGM(notepad.exe)           PARM(%FNAME)'
  110. Edit    D       *       'INT(S)'
  111. Compile F       C       'CMD(CC %NAME) WAIT'
  112. Compile F       RC      'CMD(RRCC %NAME) WAIT'
  113. Compile F       ASM     'CMD(ASM %NAME) wait'
  114. Compile F       BAS     'CMD(BASICA %NAME)'
  115. Compile F       *       'MSG(msg1)'
  116. Compile D       *       'INT(S)'
  117. Delete  F       *       'INT(D %FNAME)'
  118. Delete  D       *       'INT(RD %FNAME)'
  119. Print   F       *       'DLL(HPRINT.DLL)'
  120. Print   D       *       'INT(S)'
  121. PKZip   F       *       'DLL(HPKZIP.DLL)'
  122. PKZip   D       *       'INT(S)'
  123. PKUnZip F       *       'CMD(PKUNZIP %FNAME) wait'
  124. PKUnZip D       *       'INT(S)'
  125. Hex     F       *       'CMD(HFDUMP %FNAME) wait'
  126. Hex     D       *       'INT(S)'
  127. $eof
  128.  
  129. Figure 25
  130.  
  131. The entries after the line containing $operation are used to control
  132. what action is processed with a double- click on an entry in the File
  133. List . Entries are made up of four fields. Each field is delimited by
  134. at least one blank.  The fourth field is the action field.  The first
  135. three fields must match before an action will be processed.  If there
  136. isn't a match, then nothing happens when the User double-clicks on a
  137. file entry or directory entry.
  138.  
  139. The first field is the text that Hviews displays in the push button in
  140. the Command action override bar.   The first entry must be the word
  141. "Default" which is the default action.
  142.  
  143. The second field may only have the character "F" or "D".  This is used
  144. to match a selected entry in the File list table.  An entry with a "F"
  145. will match a file. An entry with a "D" will match a directory entry.
  146.  
  147. The third field is used to match the file type.   For example the
  148. action might be to browse a file.  This allows different browse
  149. programs to be selected based upon the file type.  The last entry for
  150. a given action type can be an asterisk (*) which will match any file
  151. type.
  152.  
  153. The fourth entry is the command to be executed.  It must be enclosed
  154. in single quotes. There are seven command types (DLL, DDE, PGM, CMD,
  155. WIN, MSG, and INT).  See the table below for an explanation of these
  156. command types.
  157.  
  158.  
  159.  
  160. DDE
  161. This command type indicates the application supports using
  162. DDE to open document files.
  163.  
  164.  
  165. PGM
  166. This command type is for executing programs (i.e. file types
  167. COM or EXE).  This entry may have a PARM passed to the
  168. program with the PARM() option.
  169.  
  170.  
  171. CMD
  172. This command type is for executing a program or batch file.  The
  173. command processor (i.e. COMMAND.COM) is loaded and the command passed
  174. to the command processor.  The CMD type may have the attribute WAIT
  175. which will prevent the window from closing on the termination of the
  176. program / batch file.  The User will be prompt to press the Enter key
  177. to continue.
  178.  
  179.  
  180. WIN
  181. This entry indicates to Hviews that the Windows extensions are
  182. to be searched for a match.
  183.  
  184.  
  185. MSG
  186. This command type will display a message. The message
  187. must be one of the messages in the file.
  188.  
  189.  
  190. INT
  191. This command type is used to execute a Hviews internal
  192. command.  Internal commands are "S" for selecting a
  193. subdirectory; "D" to delete a file entry; and "RD" to remove a
  194. directory.
  195.  
  196.  
  197. DLL
  198. This command type is used to execute an external action
  199. provided by a DLL library. The HPRINT.DLL is an example of
  200. this command type.
  201.  
  202.  
  203. Substitution variables
  204.  
  205. For this explanation assume the selected entry is ABCDEFG.EXE and the
  206. current directory is E:\WIN3.0.
  207.  
  208. There are four variables used for substituting the selected entry into
  209. the command. The variable must be terminated with a blank ,a right
  210. parentheses, or a period. If you use a period you can concatenate the
  211. remaining text with the substitution variable (i.e. %NAME.L     will
  212. be substituted as ABCDEFGL).
  213.  
  214.  
  215.  
  216. %CD
  217. The current drive and directory (i.e. E:\WIN3.0\).
  218.  
  219.  
  220. %FNAME
  221. Substitutes the full selected entry (i.e. ABCDEFG.EXE).
  222.  
  223.  
  224. %NAME
  225. The Name part of the entry(i.e. ABCDEFG).
  226.  
  227.  
  228. %EXT
  229. The extension part of the filename (i.e. EXE).
  230.  
  231.  
  232.  
  233.  
  234.  
  235. Overview of HVIEWS.WIN file
  236.  
  237. Following is a section of the operation part of the HVIEWS.WIN file.
  238. Each entry has been numbered so it can be referenced. The numbers are
  239. not part of the file and the first field must be left justified.
  240.  
  241. 1:      Default F       XLS     'DDE(EXCEL.EXE)  EXEC(EXCEL SYSTEM [OPEN{"%CD%FNAME"}])'
  242. 2:      Default F       XLC     'DDE(EXCEL.EXE)  EXEC(EXCEL SYSTEM [OPEN{"%CD%FNAME"}])'
  243. 3:      Default F       XLW     'DDE(EXCEL.EXE)  EXEC(EXCEL SYSTEM [OPEN{"%CD%FNAME"}])'
  244. 4:      Default F       XLM     'DDE(EXCEL.EXE)  EXEC(EXCEL SYSTEM [OPEN{"%CD%FNAME"}])'
  245. 5:      Default F       DOC     'DDE(WINWORD.EXE)  EXEC(WINWORD SYSTEM [FILEOPEN{"%CD%FNAME"}])'
  246. 6:      Default F       DOT     'DDE(WINWORD.EXE)  EXEC(WINWORD SYSTEM [FILEOPEN{"%CD%FNAME"}])'
  247. 7:      Default F       RTF     'DDE(WINWORD.EXE)  EXEC(WINWORD SYSTEM [FILEOPEN{"%CD%FNAME"}])'
  248. 8:      Default F       EXE     'PGM(%FNAME)'
  249. 9:      Default F       COM     'PGM(%FNAME)'
  250. 10:     Default F       PIF     'PGM(%FNAME)'
  251. 11:     Default F       BAT     'CMD(%NAME) wait'
  252. 12:     Default F       PAS     'CMD(%NAME.L) wait'
  253. 13:     Default F       BAS     'CMD(BASIC %NAME)'
  254. 14:     Default F       *       'WIN'
  255. 15:     Default D       *       'INT(S)'
  256. 16:     Browse  F       ZIP     'CMD(PKUNZIP -vn %fname) wait'
  257. 17:     Browse  F       *       'PGM(hbrow.exe)           PARM(%FNAME)'
  258. 18;     Browse  D       *       'INT(S)'
  259. 19:     Edit    F       *       'PGM(notepad.exe)           PARM(%FNAME)'
  260. 20:     Edit    D       *       'INT(S)'
  261. 21:     Compile F       C       'CMD(CC %NAME) WAIT'
  262. 22:     Compile F       RC      'CMD(RRCC %NAME) WAIT'
  263. 23:     Compile F       ASM     'CMD(ASM %NAME) wait'
  264. 24:     Compile F       BAS     'CMD(BASICA %NAME)'
  265. 25:     Compile F       *       'MSG(msg1)'
  266. 26:     Compile D       *       'INT(S)'
  267. 27:     Delete  F       *       'INT(D %FNAME)'
  268. 28:     Delete  D       *       'INT(RD %FNAME)'
  269. 29:     Print   F       *       'DLL(HPRINT.DLL)'
  270. 30:     Print   D       *       'INT(S)'
  271. 31:     PKZip   F       *       'DLL(HPKZIP.DLL)'
  272. 32:     PKZip   D       *       'INT(S)'
  273. 33:     PKUnZip F       *       'CMD(PKUNZIP %FNAME) wait'
  274. 34:     PKUnZip D       *       'INT(S)'
  275. 35:     Hex     F       *       'CMD(HFDUMP %FNAME) wait'
  276. 36:     Hex     D       *       'INT(S)'
  277.  
  278.  
  279. Figure 26
  280.  
  281. The first seven entries (1-7) provide the actions for starting
  282. programs that support Dynamic Data Exchange (DDE).  The example shows
  283. entries for Microsoft Excel and Word for Windows.  If the application
  284. isn't running, then the program name within parenthesis following the
  285. DDE keyword is used to start the application.  The document file name
  286. will be supplied by Hviews internally.  If the application is loaded
  287. and responding to DDE messages, then a DDE conversation will take
  288. place using the first token within the EXEC(...) parameter as the
  289. Application, the second token as the Topic, and the third token as the
  290. execute command to be processed by the application.  Note that the
  291. command to be processed (i.e.  within the square brackets) uses braces
  292. where parenthesis are to be used.  Hviews will translate braces to
  293. parenthesis before passing the command to the application.
  294.  
  295. The next four entries (8-11), provide the actions for starting
  296. programs that of files with the EXE, COM, PIF, and BAT  file types
  297. respectively.
  298.  
  299. The twelfth entry (12) allows for a double-click on a Pascal source
  300. file which will execute a batch file with the letter L appended to it.
  301. This batch file, for example, could link the application and execute
  302. it in one operation.
  303.  
  304. The thirteenth (13) entry allows for starting BASIC programs with a
  305. double-click on the ????????.BAS file type.
  306.  
  307. If the file type doesn't match the first thirteen entries, then the
  308. fourteenth entry (14) informs Hviews to search the [Extensions]
  309. section of the WIN.INI file for a Window application.
  310.  
  311. The fifteenth entry (15) is the default action for a double-click on a
  312. directory selection.  This invokes the internal action of selecting a
  313. subdirectory for the new current directory.
  314.  
  315. So the first fifteen entries (1-15) covers the standard actions as
  316. described in other parts of this manual.
  317.  
  318. The sixteenth (16) entry will execute program B.EXE with the selected
  319. filename as a parm.  This action will match any file type.
  320.  
  321. The seventeenth entry (17) provides for selecting the internal action
  322. of selecting a subdirectory for the new current directory when the B
  323. action is active.
  324.  
  325. The eighteenth (18) entry will execute the SPFPC program with the
  326. selected filename as a parm. When SPFPC is invoked with a filename the
  327. editor is entered directly.
  328.  
  329. The nineteenth entry (19) provides for selecting the internal action
  330. of selecting a subdirectory for the new current directory when the E
  331. action is active.
  332.  
  333. The entries twenty (20) through twenty-six (26) are used to invoke
  334. different compilers.  Depending on the file type the appropriate
  335. compiler is executed.  All these entries have the WAIT attribute which
  336. will keep the last lines of compiler output displayed until the User
  337. responds with the Enter key.  The last entry twenty-six (26),  will
  338. display a message (MSG1)  indicating no compiler available.
  339.  
  340. The twenty-seventh entry (27) provides for selecting the internal
  341. action of selecting a subdirectory for the new current directory when
  342. the C action is active.
  343.  
  344. The twenty-eight (28) and twenty-ninth (29) entries provide for
  345. deleting files and removing directories.
  346.  
  347. The thirtieth (30) entry will copy any selected file to the printer.
  348. Note that you could add additional entries to restrict what files
  349. could be sent to the printer.
  350.  
  351. The thirty-first entry (31) provides for selecting the internal action
  352. of selecting a subdirectory for the new current directory when the P
  353. action is active.
  354.  
  355. The thirty-second entry (32) executes program FDUMP which will display
  356. the file in hex.
  357.  
  358. The thirty-third and last entry (33) provides for selecting the
  359. internal action of selecting a subdirectory for the new current
  360. directory when the H action is active.
  361.  
  362. The B.EXE and FDUMP.EXE programs are provided with Hviews and are
  363. installed during the installation process.
  364.  
  365.  
  366. Running a Batch file from an Icon
  367.  
  368. A BATCH file is run as a non-Windows Application. It inherits the
  369. current environment which isn't expandable.  If the batch file has SET
  370. commands in it, the set commands will be ignored.  If the batch file
  371. runs an application that requires the set variables there are two
  372. choices:
  373.  
  374. 1
  375. Set the variables in the AUTOEXEC.BAT file.
  376.  
  377. 2
  378. Execute the COMMAND.COM program specifying an environment size
  379. (see example below).
  380.  
  381.  
  382. Following is an example using the command processor.  Assume the batch
  383. file's name is ABCDEF.BAT.  Enter the following command as the Program
  384. Path for an icon or enter it in the Run dialog box. The example
  385. specifies an environment space of 512 bytes (See your DOS manual for
  386. details).
  387.  
  388. COMMAND.COM  /E:512 /C ABCDEF.BAT
  389.  
  390. This solves the environment space problem; but when you make the
  391. application an icon the icon will be displayed with the name of
  392. "COMMAND". This is OK if you only have one batch file running; but if
  393. you have multiple batch files running and minimized they will all be
  394. titled with "COMMAND". To solve this problem copy the COMMAND.COM
  395. program naming it with a unique name.  Such as COMMANDA.COM.  Then use
  396. the following command line:
  397.  
  398. COMMANDA.COM /E:512 /C ABCDEF.BAT
  399.  
  400. Finally, make a PIF for the COMMANDA.COM file (i.e. COMMANDA.PIF) and
  401. specify the title of your choice.  Running a Batch file from the File
  402. List
  403.  
  404. When a batch file is executed from the file list (i.e. the default
  405. action "*") the COMMAND.COM program is loaded automatically (i.e. The
  406. CMD action is used) .  If you minimize the application it will be
  407. titled with "COMMAND".  If you use an action that uses the CMD action
  408. and has the WAIT parameter specified then the icon title will be
  409. "HWAIT".  For both cases the icon title can't be changed.
  410.  
  411. Hviews does allow the environment size to be specified for all CMD
  412. actions.  In the HVIEWS.INI file there is a keyword CommandEnvSize.
  413. The default value as distributed is 512 bytes.
  414.  
  415.  
  416.  
  417.  
  418. Overview of HVIEWS.INI
  419.  
  420. The following figure shows the contents of the HVIEWS.INI file as
  421. distributed on the Hviews installation diskette. The User doesn't have
  422. to change any entries within this file.
  423.  
  424. [Hviews]
  425. ACTIVE=1
  426. CommandEnvSize=512
  427. LASTWINCOMMAND=154
  428. AUTOWINARRANGE=1
  429. SAVESTATEONEXIT=1
  430. STARTFROMSAVEDSTATE=1
  431. Search_Order=2
  432. Search_Details=3
  433. FONT=-12 0 400 0 1 2 1 1 Fixedsys
  434.  
  435. [DefaultIcons]
  436. MISSING=c:\win3.1\hviews.exe 4
  437. DOS1=c:\win3.1\hviews.exe 7
  438.  
  439. [IconGroups]
  440. GROUP1=C:\win3.1\ALL.HVG All Icons
  441. GROUP2=C:\win3.1\GAMES.HVG Games
  442. GROUP3=C:\win3.1\ACCESSOR.HVG Accessories
  443. GROUP4=C:\win3.1\HVIEW.HVG Hview
  444. GROUP5=C:\win3.1\MAIN.HVG Main
  445. GROUP6=C:\win3.1\WINAPPL.HVG Win Applications
  446. GROUP7=C:\win3.1\STARTUP.HVG StartUp
  447. GROUP8=C:\win3.1\EXCEL.HVG Excel
  448. GROUP9=C:\win3.1\SDKTOOLS.HVG SDK Tools
  449.  
  450. Figure 26
  451.  
  452.  
  453. Requirements
  454.  
  455.  
  456. Listed below are the software and hardware requirements:
  457.  
  458.  
  459.  
  460. * Microsoft Windows 3.0 (or later)
  461. * A mouse is recommended
  462. * Personal computer using the 80286, 80386SX, 80386DX, or higher
  463. * One 5.25" high-density (1.2MB) disk drive and a hard disk
  464. * Color monitor is recommended
  465.  
  466.  
  467. Hviews files
  468.  
  469. Listed below are the files supplied with Hviews
  470.  
  471. FILE          Function                  Copied to Hard Disk
  472.  
  473. HVIEWS.EXE    Hviews application             Yes
  474. HVIEWSB.EXE   Hviews Builder application     Yes
  475. HVIEWS1.DLL   DLL used by Hviews             Yes
  476. HVIEWS2.DLL   DLL used by Hviews             Yes
  477. HVIEWS3.DLL   DLL used by Hviews             Yes
  478. HVIEWS4.DLL   DLL used by Hviews             Yes
  479. HVIEWS5.DLL   DLL used by Hviews             Yes
  480. HVIEWS.INI    Hviews control file            Yes  (If first time)
  481. HVIEWS.WIN    Hviews action control file     Yes  (If first time)
  482. *.HVG         Icon group files               Created by HVIEWSB
  483. HVIEWS.HVI    Icon database of associations  Created by HVIEWSB
  484. HVIEWS.HLP    Hviews help file               Yes
  485. HWAIT.EXE     Used for wait function         Yes
  486. HBROW.EXE     File browser                   Yes
  487. HPKZIP.DLL    Zip DLL                        Yes
  488. HPKZIP.HLP    Zip DLL help file              Yes
  489. HVIEWSB.HLP   Hviews Builder help file       Yes
  490. HBROW.HLP     HBROW help file                Yes
  491. COMMDLG.DLL   COMMDLG.DLL                    Maybe
  492. APPSETUP.INF  Install control file           NO
  493. INSTALL.EXE   Installation program           NO
  494.  
  495.  
  496. Figure 27
  497.  
  498.  
  499.  
  500. Error Messages
  501.  
  502. The following table of error numbers are caused by errors in the
  503. HVIEWS.WIN file.  If you can't find the problem, then replace it with
  504. a backup copy or a copy from the distribution disk.
  505.  
  506. The message number will be displayed in a Message box.  Hviews will
  507. proceed with initialization;  but the Command override bar may not
  508. function properly.
  509.  
  510.  
  511. # Error message
  512.  
  513.  
  514. 1    DOS eof found before $eof
  515. 2    Action character missing (Must be first character on line)
  516. 3    Action greater than 2 characters
  517. 4    2 nd field must be F or D
  518. 5    3 nd field must not be greater than 3 characters
  519. 6    4 th field must not be greater than 80 characters
  520. 7    Same as error 2
  521. 8    2 nd field missing
  522. 9    3 nd field missing
  523. 10   4 th field missing
  524. 11   Out of memory - Too many actions
  525. 12   No actions
  526.  
  527.  
  528. Figure 28
  529.  
  530.  
  531.  
  532.